Skip to content

feat(traffic-guardian): add runtime monitoring skill baselines#217

Merged
davida-ps merged 3 commits into
mainfrom
codex/runtime-traffic-guardian-specs
May 10, 2026
Merged

feat(traffic-guardian): add runtime monitoring skill baselines#217
davida-ps merged 3 commits into
mainfrom
codex/runtime-traffic-guardian-specs

Conversation

@davida-ps
Copy link
Copy Markdown
Collaborator

@davida-ps davida-ps commented May 4, 2026

User description

Summary

  • Add spec-only runtime traffic guardian skill scaffolds for OpenClaw, Hermes, NanoClaw, and Picoclaw
  • Define per-platform frontmatter, skill metadata, SBOM placeholders, folder structures, and SPEC.md implementation contracts
  • Update the README support matrix and wiki module docs to mark runtime traffic monitoring as a spec baseline

Testing

  • python3 utils/validate_skill.py skills/openclaw-traffic-guardian
  • python3 utils/validate_skill.py skills/hermes-traffic-guardian
  • python3 utils/validate_skill.py skills/nanoclaw-traffic-guardian
  • python3 utils/validate_skill.py skills/picoclaw-traffic-guardian
  • jq empty skills/openclaw-traffic-guardian/skill.json skills/hermes-traffic-guardian/skill.json skills/nanoclaw-traffic-guardian/skill.json skills/picoclaw-traffic-guardian/skill.json
  • npm run gen:wiki-llms
  • npm run build

Notes

These packages intentionally do not implement proxy runtime code yet. They reserve platform-specific landing zones for builders while documenting the safety contract: opt-in, detect-and-log, no automatic system CA install, no global proxy mutation, and no blocking in the first implementation.


Generated description

Below is a concise technical summary of the changes proposed in this PR:
Document new runtime traffic guardian spec baselines for OpenClaw, Hermes, NanoClaw, and Picoclaw so each platform reserves metadata, SBOM placeholders, safety contracts, and SPEC/README guidance for future proxy builders. Highlight the new runtime traffic monitoring capability in the README feature matrix and multilingual wiki indexes/modules so reviewers understand the architectural purpose of the guard family.

TopicDetails
Platform Guard Scaffolds Announce and scaffold per-platform runtime traffic guardian skills by defining changelog/README guidance, SBOM-aware skill.json, SKILL.md, SPEC.md, and placeholder directories so each platform has a safe opt-in landing zone for future proxy runtime work.
Modified files (34)
  • skills/hermes-traffic-guardian/CHANGELOG.md
  • skills/hermes-traffic-guardian/README.md
  • skills/hermes-traffic-guardian/SKILL.md
  • skills/hermes-traffic-guardian/SPEC.md
  • skills/hermes-traffic-guardian/lib/.gitkeep
  • skills/hermes-traffic-guardian/scripts/.gitkeep
  • skills/hermes-traffic-guardian/skill.json
  • skills/hermes-traffic-guardian/test/.gitkeep
  • skills/nanoclaw-traffic-guardian/CHANGELOG.md
  • skills/nanoclaw-traffic-guardian/README.md
  • skills/nanoclaw-traffic-guardian/SKILL.md
  • skills/nanoclaw-traffic-guardian/SPEC.md
  • skills/nanoclaw-traffic-guardian/host-services/.gitkeep
  • skills/nanoclaw-traffic-guardian/lib/.gitkeep
  • skills/nanoclaw-traffic-guardian/mcp-tools/.gitkeep
  • skills/nanoclaw-traffic-guardian/skill.json
  • skills/nanoclaw-traffic-guardian/test/.gitkeep
  • skills/openclaw-traffic-guardian/CHANGELOG.md
  • skills/openclaw-traffic-guardian/README.md
  • skills/openclaw-traffic-guardian/SKILL.md
  • skills/openclaw-traffic-guardian/SPEC.md
  • skills/openclaw-traffic-guardian/hooks/openclaw-traffic-guardian-hook/.gitkeep
  • skills/openclaw-traffic-guardian/lib/.gitkeep
  • skills/openclaw-traffic-guardian/scripts/.gitkeep
  • skills/openclaw-traffic-guardian/skill.json
  • skills/openclaw-traffic-guardian/test/.gitkeep
  • skills/picoclaw-traffic-guardian/CHANGELOG.md
  • skills/picoclaw-traffic-guardian/README.md
  • skills/picoclaw-traffic-guardian/SKILL.md
  • skills/picoclaw-traffic-guardian/SPEC.md
  • skills/picoclaw-traffic-guardian/lib/.gitkeep
  • skills/picoclaw-traffic-guardian/scripts/.gitkeep
  • skills/picoclaw-traffic-guardian/skill.json
  • skills/picoclaw-traffic-guardian/test/.gitkeep
Latest Contributors(1)
UserCommitDate
David.a@prompt.securitychore(traffic-guardian...May 10, 2026
Docs & Matrix Refresh the README feature matrix and every localized wiki index/generation record plus the new runtime-traffic-guardian-baseline module page to explain how runtime traffic monitoring slots into the ClawSec roadmap.
Modified files (14)
  • README.md
  • wiki/GENERATION.md
  • wiki/INDEX.md
  • wiki/de/GENERATION.md
  • wiki/de/INDEX.md
  • wiki/es/GENERATION.md
  • wiki/es/INDEX.md
  • wiki/fr/GENERATION.md
  • wiki/fr/INDEX.md
  • wiki/ja/GENERATION.md
  • wiki/ja/INDEX.md
  • wiki/ko/GENERATION.md
  • wiki/ko/INDEX.md
  • wiki/modules/runtime-traffic-guardian-baseline.md
Latest Contributors(2)
UserCommitDate
David.a@prompt.securityfeat(traffic-guardian)...May 04, 2026
david@abutbul.comfeat(i18n): add multil...April 29, 2026
This pull request is reviewed by Baz. Review like a pro on (Baz).

@davida-ps
Copy link
Copy Markdown
Collaborator Author

pending agent tests

@davida-ps davida-ps force-pushed the codex/runtime-traffic-guardian-specs branch from 8b61cc5 to 6ad3b1f Compare May 10, 2026 11:50
Comment on lines +60 to +62
"hermes": {
"emoji": "TG",
"category": "security",
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we update the release catalog builder to read the new hermes/nanoclaw/picoclaw metadata instead of .openclaw.emoji/.openclaw.category, since this file lacks openclaw and chained jq lookup will fail during public/skills/index.json generation? (Also consider normalizing the builder or adding an openclaw alias to satisfy SkillMetadata’s string emoji/category shape.)

Finding type: Breaking Changes | Severity: 🔴 High


Want Baz to fix this for you? Activate Fixer

Other fix methods

Fix in Cursor

Prompt for AI Agents:

Before applying, verify this suggestion against the current code. In
skills/hermes-traffic-guardian/skill.json around lines 60-62 (the top-level `hermes`
block defining `emoji` and `category`), the manifest no longer provides an `openclaw`
object, but the catalog builder’s jq lookup expects `.openclaw.emoji` and
`.openclaw.category` and will fail during `public/skills/index.json` generation. Fix by
either adding an `openclaw` alias object that mirrors the existing `hermes.emoji` and
`hermes.category`, or (preferably) updating the builder to normalize metadata by
platform by falling back to `<platform>.emoji`/`<platform>.category` when `openclaw` is
absent, while still producing the string fields required by `SkillMetadata`. Ensure the
published catalog generation no longer errors when a skill uses the new `hermes`
metadata shape.

Comment on lines +72 to +76
"nanoclaw": {
"mcp_tools": [
"clawsec_traffic_status",
"clawsec_traffic_findings",
"clawsec_traffic_check_config"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since this manifest only defines nanoclaw but builders expect SkillJson.openclaw.{emoji,category,triggers} and read .openclaw.emoji/.openclaw.category, populate-local-skills.sh and the deploy job will serialize emoji/category as null and make public/skills/index.json diverge from SkillMetadata — should we add the missing openclaw metadata here or update the builders/schema to honor platform before publishing the traffic-guardian skills?

Finding type: Type Inconsistency | Severity: 🟢 Low


Want Baz to fix this for you? Activate Fixer

Other fix methods

Fix in Cursor

Prompt for AI Agents:

Before applying, verify this suggestion against the current code. In
skills/nanoclaw-traffic-guardian/skill.json around lines 72-76, the manifest defines
only the `nanoclaw` block and omits the required `openclaw` metadata
(`SkillJson.openclaw.emoji` and `SkillJson.openclaw.category`, and any required
`SkillJson.openclaw.triggers` fields per the contract). Add an `openclaw` section to
this file with valid `emoji` and `category` values (and `triggers` if required) so
scripts/populate-local-skills.sh and the deploy job can stop serializing them as null
and the generated public/skills/index.json matches SkillMetadata. If you cannot
determine the correct category/triggers, pick the closest existing values used by other
published skills in the repo and ensure the schema validation passes.

@davida-ps davida-ps merged commit 3697458 into main May 10, 2026
19 checks passed
@davida-ps davida-ps deleted the codex/runtime-traffic-guardian-specs branch May 10, 2026 12:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant